home *** CD-ROM | disk | FTP | other *** search
/ PC Media 2 / PC MEDIA CD02.iso / share / udos / kack10 / kack.doc < prev   
Encoding:
Text File  |  1992-07-11  |  4.6 KB  |  109 lines
  1.  
  2.  
  3.            ┌────────────────────────────────────────────
  4.            │
  5.            │                                            ██
  6.            │        Documentation for KACK v1.0         ██
  7.            │                                            ██
  8.            │                                            ██
  9.              █████████████████████████████████████████████
  10.              ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  11.  
  12.    ┌─────────────────
  13.    │                 █
  14.    │   Quick start   █
  15.    │                 █
  16.     ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  17.  
  18.    KACK is short for Key Accelerate & Click Key.   It is a  program
  19.    which speeds up the typematic rate of the keyboard  and/or gives
  20.    a click each time pressing a key.  Entering  only `KACK'  at the
  21.    command line gives you this message:
  22.  
  23.     Usage: KACK /<C n Px U>
  24.            /C for key Clicks
  25.            /n (1..4) keyspeed
  26.            /P x = tone period (100..10000)
  27.            /U unload from memory
  28.  
  29.    Case of the argument is irrelevant. Some examples of usage:
  30.  
  31.       KACK /1       gives lowest repeat rate (about 7.5cps).
  32.       KACK /4       gives fastest repeat rate (about 30cps).
  33.       KACK /C /4    as above plus making clicks.
  34.       KACK /C4p200  as above with higher tone
  35.       KACK /U       remove from memory if resident.
  36.  
  37.    The program  goes resident if the click function (/C) is chosen.
  38.    No click is heard when a key is released, neither when  pressing
  39.    a shift-key (Alt, Ctrl, LeftShift or RightShift). Changing type-
  40.    matic rate is only possible on an AT or better. The PC/XT hasn't
  41.    the 8042 keyboard processor which does this possible.
  42.  
  43.  
  44.  
  45.    ┌─────────────────
  46.    │                 █
  47.    │ Technical notes █
  48.    │                 █
  49.     ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  50.  
  51.    As a TSR, KACK will occupy only 160 bytes.  This exceptional low
  52.    memory usage is  accomplished by using  assembly language and by
  53.    disposing most of the PSP. Most of this PSP area is of no use to
  54.    this program. Many textbooks warns agains modifying values below
  55.    5Ch,  but the word at 5Ch (DOS  function  dispatched) is a left-
  56.    over  from the CP/M  days.  I have found no program that rely on
  57.    this value. Certainly not this program.  (BTW, PkLite 1.14  puts
  58.    the word 4B50h ('PK') at this location).
  59.  
  60.    If you wish to use a similar technique when making TSRs, be sure
  61.    to leave the start of the PSP unchanged as this area is used for
  62.    restoring  interrupt vectors when  exiting the program.  Consult
  63.    your technical literature for information on the PSP. The inter-
  64.    rupt list  edited by  Ralf Brown is an indispensable tool.  Look
  65.    for INTER30?.ZIP or later on BBSes or at a shareware supplier.
  66.  
  67.    The program also releases its environment block  when going TSR.
  68.    Thus  making the program invisible to memory  mapping  utilities
  69.    like  MapMem or  Manifest when running MS-DOS prior to MS-DOS 5.
  70.    To make the  memory  hole left by the environment block as small
  71.    as possible,  reduce  your  environment as much as  possible. If
  72.    installed in your  AUTOEXEC.BAT place the call  before your PATH
  73.    or PROMPT statement.  If your are  using 4DOS, a simple trick is
  74.    to put a `@' before `KACK'.  This will  reduce some  environment
  75.    space.
  76.  
  77.    To unload  the  program enter `KACK /u'  at the DOS prompt. This
  78.    frees the memory used (even if loaded high).  If any TSR  loaded
  79.    after KACK grabs the keyboard interrupt, unloading becomes impos-
  80.    sible.  KACK will have no way of knowing the last owner of INT 9.
  81.    This is the only interrupt  KACK is hooking. If the memory block
  82.    associated with KACK has  become  destroyed, execution halt with
  83.    an error message. See the source code in KACK.8 for details.
  84.  
  85.    This program is released as FreeWare. Use the accompanied source
  86.    code with caution. You are free to modify it as you pleases, but
  87.    leave my name in as the originator of the code.  The program has
  88.    undergone tests on several PCs with MS-DOS 3.2,  MS-DOS 5.0  and
  89.    DR-DOS 6.0. No problems has been noted. If you have any problems
  90.    using KACK, or find any errors or  incompatabilities please drop
  91.    me a message through one of the following channels:
  92.  
  93.  
  94.      InterNet:     giva@oscar.bbb.no
  95.      Fido:         2:502/503
  96.      PolarNet:     GISLE VANEM @YRO         (for Norwegians mostly)
  97.      RIME conf:    Software or shareware
  98.      ILink conf:   Shareware & Reviews
  99.      Snail-Mail:   Gisle Vanem, Breimyra 56
  100.                    5091 Flaktveit, Bergen, NORWAY
  101.                    tel. +47-5-188249
  102.  
  103.  
  104.    Enjoy!
  105.  
  106.  
  107.  
  108.                                                        9. July 1992
  109.